home *** CD-ROM | disk | FTP | other *** search
/ BMUG Revelations / BMUG Revelations.toast / Utilities / System 7 / AWOL Utilities 1.1 / Menu Events 1.1 / Menu Events Help / Menu Events Help.rsrc / STR#_1030.txt < prev    next >
Encoding:
Text File  |  1994-04-01  |  4.0 KB  |  219 lines
  1. 
  2.  
  3. 
  4.  
  5. l
  6.  
  7. l
  8.  
  9. åLimitations
  10.  
  11. 
  12.  
  13. 
  14.  
  15. Some applications refuse to submit to the trickery of Menu Events.  The
  16.  
  17. prime example is any version of Finder which predates the Power
  18.  
  19. Macintosh (version 7.1.2).  It is not truly an Apple event server, and it
  20.  
  21. only respects events of known types.  Any other high-level event is not
  22.  
  23. replied to, and the send will time out.  ResEdit 2.1.1 is similar.  Some
  24.  
  25. Microsoft applications handle Apple events in a non-standard fashion,
  26.  
  27. binding their own event handlers over all Apple event classes, and
  28.  
  29. therefore should not be targeted.
  30.  
  31. 
  32.  
  33. 
  34.  
  35. The only way to know for sure is to try the ones you are interested in
  36.  
  37. controlling.  Certainly, anything you write yourself is a candidate, as long
  38.  
  39. as you follow the practices suggested in Apple documentation, namely:  Be
  40.  
  41. high-level-event-aware.  Always be ready to accept and dispatch an
  42.  
  43. Apple event.  Assume that any high-level event you don‚Äôt recognize is an
  44.  
  45. Apple event, and dispatch it as such.  If an unknown event reaches your
  46.  
  47. wildcard event handler, return errAEEventNotHandled, so that system
  48.  
  49. event handlers can get a crack at it.  Don‚Äôt deny other programs on the
  50.  
  51. same machine the right to request user interaction, which is the default.
  52.  
  53. 
  54.  
  55. Another limitation you should know about is that Menu Events can‚Äôt
  56.  
  57. operate dialogs and alerts which the target application may post in
  58.  
  59. response to the menu action.  If the menu item text ends in an ellipsis
  60.  
  61. ('‚Ķ') character, you can bet that the application will post a dialog or alert
  62.  
  63. box.  It is then up to the local user to operate the controls.
  64.  
  65. 
  66.  
  67. A known conflict exists between Menu Events and Help on Wheels.  If you
  68.  
  69. send a Menu event to an application which does a casual help display
  70.  
  71. before performing the menu action, and if the help server is running,
  72.  
  73. problems may occur with the application.  The problem is that the Menu
  74.  
  75. event‚Äôs user interaction ends when the receiving application sends an
  76.  
  77. Apple event to the help server, causing it to return to the background.  If
  78.  
  79. the menu action causes a call to the Standard File Manager or any other
  80.  
  81. code which should not be called when in the background, the application
  82.  
  83. may hang.
  84.  
  85. 
  86.  
  87. 
  88.  
  89. 
  90.  
  91. 
  92.  
  93. –
  94.  
  95. –
  96.  
  97. √•Programmer Notes
  98.  
  99. 
  100.  
  101. 
  102.  
  103. Write to the author at the above address if you want to know more about
  104.  
  105. the Menu Events extension or how it was programmed.
  106.  
  107. 
  108.  
  109. 
  110.  
  111. 
  112.  
  113. 
  114.  
  115. 
  116.  
  117. 4
  118.  
  119. 4
  120.  
  121. åAcknowledgements
  122.  
  123. 
  124.  
  125. 
  126.  
  127. Thanks to C.K. Haun and the other folks at Apple Developer Technical
  128.  
  129. Support who put together those clever little code snippets which give
  130.  
  131. folks like me such odd ideas.
  132.  
  133. 
  134.  
  135. 
  136.  
  137. Special thanks to the many fine people who beta-tested this software,
  138.  
  139. including Ken Linger, Chris Reynolds, Michele Marques, Chris Kaltwasser,
  140.  
  141. James Edward Davis, and Leonard Rosenthol.
  142.  
  143. 
  144.  
  145. 
  146.  
  147. 
  148.  
  149. 
  150.  
  151. ò
  152.  
  153. ò
  154.  
  155. √•Revision History
  156.  
  157. 
  158.  
  159. 
  160.  
  161. 1.1 (March 28, 1994)
  162.  
  163. ‚Ä¢  Public AWOL Utilities 1.1 release.
  164.  
  165. ‚Ä¢  Documented that Menu Events works with Finder 7.1.2.
  166.  
  167. 
  168.  
  169. 1.0.7 (March 13, 1994)
  170.  
  171. ‚Ä¢  Menu Events Help presents a useful message if the user tries to open or
  172.  
  173. print it when the help server is absent.
  174.  
  175. 
  176.  
  177. 1.0.6 (February 27, 1994)
  178.  
  179. ‚Ä¢  Added protection against loading duplicate copies of the extension.
  180.  
  181. 
  182.  
  183. 1.0.5 (February 6, 1994)
  184.  
  185. ‚Ä¢  Improved compatibility with At Ease and other applications which flush
  186.  
  187. mouse-down events when they become active.
  188.  
  189. 
  190.  
  191. 1.0.4 (January 30, 1994)
  192.  
  193. ‚Ä¢  If the Shift key is pressed on startup, the extension will not be loaded.
  194.  
  195. If the Help or Command-? key is pressed, the extension will delay up to
  196.  
  197. one second to let the user release the key(s).
  198.  
  199. 
  200.  
  201. 1.0.3 (January 19, 1994)
  202.  
  203. ‚Ä¢  Added ‚ÄúMenu Events 'aete'‚Äù resource file.
  204.  
  205. 
  206.  
  207. 1.0.2 (January 11, 1994)
  208.  
  209. ‚Ä¢  Fixed bug which sent the target application into a notification wait state
  210.  
  211. if it received a Menu event from a remote sender.
  212.  
  213. 
  214.  
  215. 1.0.1 (December 31, 1993)
  216.  
  217. ‚Ä¢  Initial AWOL Utilities 1.0.1 release.
  218.  
  219.